<!DOCTYPE HTML>
<html lang="en">
<head>
  <meta name="copyright" content=
  "Copyright (c) IBM Corporation and others 2000, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page.">
  <meta charset="utf-8">
  <link rel="STYLESHEET" href="../book.css" type="text/css">
  <title>Running External Tools</title>
  <script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"></script>
</head>
<body>
  <h1>Running External Tools</h1>
  <p>The Workbench provides a mechanism for running tools that are not part of it. To configure an external tool:</p>
  <ol>
    <li>Click <a class="command-link" href=
    'javascript:executeCommand("org.eclipse.ui.externalTools.commands.OpenExternalToolsConfigurations")'><img src=
    "PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link"> <b>Run &gt; External Tools &gt; External
    Tools...</b></a>.</li>
    <li>Select the Program configuration</li>
    <li>Click the <b>New</b> button.</li>
    <li>Enter a name for your external tool (for example, My External Tool).</li>
    <li>Click the <b>Browse File System</b> button.</li>
    <li>Find the tool you want to run (for example, on Windows it is usually a file with the extension .exe or
    .bat).</li>
    <li>(Optional) In the <b>Arguments</b> field enter the necessary arguments for the tool.</li>
    <li>(Optional)In the <b>Working directory</b> field enter the working directory for the tool.</li>
    <li>Click <b>Run</b>.</li>
  </ol>
  <p>These steps create a persisted launch configuration. The newly created configuration will appear in the launch
  history under <b>Run &gt; External Tools</b> and will be available in the launch configuration dialog which is opened
  by clicking <a class="command-link" href=
  'javascript:executeCommand("org.eclipse.ui.externalTools.commands.OpenExternalToolsConfigurations")'><img src=
  "PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link"> <b>Run &gt; External Tools &gt; External
  Tools...</b></a>.</p>
  <p>It is also possible to set up and run an external tool to build a project.</p>
  <ol>
    <li>Select the desired project.</li>
    <li>From its pop-up menu choose <b>Properties</b>.</li>
    <li>Click <b>Builders</b> from the list, and configure the tool as described above.</li>
  </ol>
  <h3 class="related">Related Concepts</h3><a href="../concepts/concepts-exttools.htm">External tools</a>
  <h3 class="related">Related Tasks</h3><a href="./tasks-ant-running.htm">Running Ant buildfiles</a>
</body>
</html>
